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Introduction 


This document lists the services (SVCs) that the TCS Master provides to the 
operating system or diagnostic programs running on the TC2000. It describes 
the commands to be given and describes the responses that will be generated. 


SVC Request Protocol 


There is a one-byte HIE number or “code” associated with each SVC com: 
mand which the TCS Master reads from location to_tes_emd in page zero. 


The argument and response areas reside in the node's physical memory, The 
arguments are read from physical memory pointed to by fo_tes_args located in 
page zero, The argumentarea may or may not be located in page zero. Similar- 
Iv. the results are returned into a physical memory area pointed to by 


from_tcs_response. The argument and response areas most both be word-al- 


izned. 


The results are valid when the TCS Master clears to_tes_emd. Immediately 
after clearing the command byte. the TCS Master will assert 
FROM_TCS_SRV_DONE in location from_tes_bits (which resides in page 
Zero). If oan errer occurs in processing the SVC request. 
FROM_TCS_SRV_ERR will also simultaneously be set. The TCS Master will 
then cause an interprocessor interruptif TO_TCS_SRV REQ_INT_EN ty setin 
the pave zero location to_tes_bits. 


An SVC command summary along with the format and values for each SWC 
argument and response area are detailed in later sections. 
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BootStrap Variastes 


The TCS Master maintains block of sixteen 32-bit variables for use by the 
operating system and its bootstrap. These can be set from the 
“BOOTCEG.TCS*” file. and can be set and retrieved via SVC requests. 


These variables are designed to be stored in non-volatile memory during the 
process of booting or re-booting the operating system. 


The TCS Master assigns meaning to the first wo “bootstrap” variables (zero 
andone). Bootstrap variable{0| represents the current panic count, while vari- 
able[ I] represents the panic limit. The remaining fourteen variables are unin- 
terpreted by the TCS Master 

The TCS Master also maintains one variable string. the “boot string”, in the 
same way. This string is typically “(sd 1.0.0)vmunix”, The current boot string 
will have been read from the “BOOTCFG.TCS” file or from an 
SVC_SET_BOOTSTRING SVC command. The boot string may be up to 137 
characterslong and is NULL terminated. 


SVC Commands 


This section provides a summary of each SVC command by “code” number. 
followed by it’s category and a brief description. The SVCs are broken up inte 


SiX Categories: 
1. Card State Support SVC Functions 


2. Sdriver Support SVC Functions 


tne 


. BootStrap Support SVC Functions 
4. Diagnostic Support SVC Functions 


_ DOS File Support SVC Functions 


tn 


6. TCS Slave Request SVC Functions 


1.4.1 SVC Command Surmmary List 

Code Mneumonic Category Description 

a0 SVC_NONI No Command 

10 SVC_SET_COMP_STALI Card State Set desired state of card 

I SVC_GET_COMP STAT Card State Read current state of card 

12 SVC SELEY XOLE Sdriver Set Sdriver tty _off parameter 

13 SVC_GET_ULY_ NOEL Sdriver Read current state of tty _off 

4 SVCUSEV JENEE PLEIN Sdriver Set Modem dialup enable parameter 
15 SVC_GET_DIALUPLENN Sdriver Read modem dialup enable state 
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16 SVC_SET_DIALUP_PWD Sdriver Set modem password 

17 SVC_GET_DIALUL P_PWD Sdriver Read Modem password 

Is § SVC_SET_DIALUP_INI Sdriver Set modem init string 

19 SVC_GET_DIALL P_LINI Sdriver Read modem init string 

IA SVC_GET_TEX_VER Read TEX version number 

IB SVC_GET_SDRIVER_VER Sdriver Read Sdriver version number 

Cc SVC_GET_DIALUP_LOGGED Sdriver Read modem login flag 

20) SVC_SHUTDOWN BootStrep Shutdown system 

2 SVC_REBOOL Bootstrap q vstem. CountNY panics 

22 SVC_REREAD CONFIG ration tiles 

23 SVC_GET_BOOTSERING Read current boot string 

24 SVC_SEL_ BOOTSERING Set boot string 

25 SVC_GEF_BOOTVAR Read bootstrap variahle 

2h SVC_SET_BOOIVAR Set bootstrap varrable 

27 SVC_GET_CALENDAR Bootstra) Read PCS Master’s callendar clock 
an SVC_SET_CALENDAR Bootstrap Set PCS Master’s calendar clock 
29 SVC_EXIL Bootstrap Exit (Return to PRX prompu 

24, SVC_WARM_ BOOT NODI Bootstrap Warm boot a processor node 

2B sVC_COLD_BOOT_NODI Bootstrap Cold boot a processor/node 

2c SVC_START_ NODE BootsStrap Reset start a processor node 

2D SVC_CONFIG_ARRAY Bootstrap Load configuration table into a node 
aE SVC_LYPRKSCRIPT Bootstrap 2 ta “teyhalt.tes” file 


30) SVO_DO_UBQOT NODE Dragnosue Dowmgad UBOOT into a node 
at ee ) POSIKNODE Dragnosuc oad POST into a node 
= SVCORILI NOD Diagnostic Halt and power down a node 
‘33 SVCO_JUMPLAPP_ Diagnostic Change slave node. do app tly 
ih. 

45 SVC_DOS_REAN DOS Perform a read on a DOS Tile 

4o sVC_DOS_WRII \ DOS Perform a write on a DOS Tile 

49 SVC_DOS_DELF TE DOS Delete a DOS file 

dN SVC_DOS_MRDIR \ Perform a mkdir on DOS file system 

4B SVC _DOS_RMDIR Perform a rmdir on DOS filke system 
SVC _DOS_GEICWH Read current directory 
SVC _DOS_OPLEN DOS Open a DOS file 
SVC_DOS_CLOSI DOS Close a DOS Tile 
SVC_DOS_SEEK Dos Seek on a DOS file 

A) SVC_DOS_READIN DOS Read a text line from a DOS Tile 

x0) SVO_LTCS_RD_ACTION ICS Shave Read Action Register 

NI SVC_LTCS WR ACTION IOS Shave Write Action Register 

s2 SVC_LECS_RD_ EEPROM TCS Slave Read EPROM Register 

s3 SVC_ECS WROEE PROM ICS Slave Write LE PROM Register 

s4 SVCLTCS RD_GALE ARRAY TCS Slave Read Gatearry Register 

NS SVC_TCS_ WR_GATE ARRAY ECS Slave Write Gatearray Register 

x6 SVC_ECS_RD_UWARE ICS Slave Read Flardware Register 

N7 SVC_TCS_WR_HWARI ICS Shave Write Hardware Register 

SS SVC_ECS_TBUS_ RD ICS Shive Perform Pus read-eyele 

SY SVC_UICS_IBUS WR ECS Shave Perform Pbus write cvele 
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Sdriver 
Sdriver 
Sdriver 
Suriver 


Sdriver 


BootStrap 
Bootstrap 
BootSuap 
Bootstrap 
Bootstrap 
Bootstrap 
Bootstrap 
Bootstrap 
Bootstrap 
Bootstrap 
BootStrap 
BootStrap 
BootsStrap 
BootStra 
BootStry 
BootStrap 


Diagnostic 
Diagnosue 
Diagnostic 
Diagnostic 


DOS 
DOS 
DOS 
DOS 
DOS 
DOS 
DOS 
DOS 
DOS 
DOS 


ICS Shue 
PCS Shug 
ICS Skive 


TCS Shue 
TCS Shue 


Css 


lave 


16. SVC_SET_DIALUP_PWD 
17 SVC_GET_DIALUP_PWD 
Is SVC_SET_DIALUP_INI 

19 SVC_GET_DIALUP_INI 

1A SVC_GET_TEX_VER 

IB SVC_GET_SDRIVER_VER 
IC SVC_GET_DIALUP_LOGGED Sdriver 
alt) SVC_SHUTDOWN 

2 SVC_REBOOT 

a SVCO_RERFAD_CONFIG 
23 SVCO_GET_BOOTSTRING 
M SVC_SET_BOOTSTRING 
28 SVC_GET_BOOTVAR 

2% SVC_SET_BOOTVAR 

7 SVCO_GET_CALENDAR 

28 SVC_SET_CALENDAR 

29 SVC_EXIT 

2A SVC_WARM_BOOT_NODE 
2B SVC_COLD_BOOT_NODE 
2 SVC_START_NODE 

2» SVC_CONTIG_ARRAY 

iy SVC_PYPESCRIPI 

2 SVC_LREN_ SCRIPT 

w SVCO_DO_UBOOT_NODI 
31 SVO_DO_POST_NODI 

32 SVC_RIEE_NODI 

33 SVC_JUMP_APP_NODI. 

45 SVC_DOS_RE AD 

46 SVC_DOS_WRITE 

49 SVCO_DOS_DELETI 

4A SVC_DOS_MKDIR 

4B SVC_DOS_RMDIR 

iG SVO_DOS_GEECWD 

4p SVC_DOS_OPLN 

4I SVO_DOS_CI OSI 

4! SVCO_DOS_SEEK 

30 SVO_DOS_RE ADIN 

sui SVO_ECS_RD_ACHON 

xI SVC_ECS, WRLACHION 

B2 SVC_ICS RD_EL PROM 

SS SVO_TECS WE EPROM 
sd SVO_ECS_RD_GATE ARRAY 
SS SVCO_ECS_WR_GALL ARRAY 
SO SVCO_ECS_RD_EAWART 

S7 SVC_ECS WIRTIWARI 

SS SVC_ICS “IBUS_RD 

so SVC_ICS “TBUS_WI 


TCS Shive 
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Set modem password 

Read Modem password 

Set modem init string 

Read modem init string 
Read VEX version number 
Read Sdriver version number 
Read modem login flag 


Shutdown system 

Reboot system. counting panics 
Reread configuration files 

Read current boot string 

Set boot string 

Read bootstrap variably 

Set bootstrap variable 

Read PCS Master's calendar clock 
Sew lCS Master's calendar clock 
Exit (Return to TEX prompt) 
Warm boot a processor node 

Cold boot a processer node 

Reset stitrt a processor node 

Load configuration table into a node 
Save console-log to “ty hall tes” file 
Save and rename console: log file 
Download CBOOT inte a node 
Download POST inte a nade 

Halt and power down a node 
Change slave node. do app tty 


Perform a read on a DOS file 
Perform awrite on a DOS Tile 
Delete a DOS Tile 

Perform a mkdir on DOS file system 
Perform a rmdir on DOS Tike system 
Read current directory 

Open a DOs file 

Close a DOS Tile 

Seek ona DOS file 

Read atest tine from a DOS Tile 


Read Action Register 
Write Action Register 
Read EEPROM Register 
Write EEPROM Register 
Read Gatearrs Register 
Write Gatearray Regier 
Read Hardware Register 
Write Hardware Register 
Perform Thus read: ovele 
Perform Vbus writeeevele 
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1.5 SVC Command Descriptions 


This section provides a detailed description of each SVC command. The argu- 
ment and response data areas for each command are described for use by the 
diagnostic and operating system programmers, The SVC command descrip- 
tions are described in “code” number order. as found in the SVC summary list. 


1.5.4 Argument and Response Data Areas 


SVCs that require arguments retrieve those arguments from the argument 
data area. Which is pointed by fo_fes_args page zero location, Not all the SVCs 
have the same argument format. The same holds true for SWC results. The 
SVC results are stored in the response data area pointed to by from_tes_re- 
sponse located in page zero. The result data format may or may not be the same 
foreach SVC. Both the argument and response data areas can be at most 132 
bytes or UXS4 hex bytes in size. 


to_tes_bits from_tcy_cmd 
to_tes_cmd from_tcs_bits 
TCS_10 -> =A 
y ff 6 


boot_bits 
halt_bits 


_ response 


RESPONSE 


AREA 


ARGUMENT AREA 
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SVC Functiori Descriptions 


00 SVC_NONE 


This is the state of fo_tes_cmd (page zero) when no SVC request is pending. 


10 SVC_SET_COWMP_STATE 
Set the desired state for the selected card. 
This command causes the TCS Master to begin changing the state of the se- 


lected card. Since some state changes take ime, such as running microboot or 
POST. the tinal desired state may not be achieved immediately. 


Arguments: 
byte 0 Card Class: Type 
byte | CGnused. for alignment 
bytes 2-3 Card Index 
byte 4 Card State 
Response: 
NONE 
ii SVC_GET_COMP_ST/ 


Read the current state for the selected card. 


Arguments: 


byte 0 Card Class/Ivpe 
byte | Unused. for alignment 
byte 2-3 Card Inde 


Response: 
byte 0 Non-zero if the curd has responded tow 1 CS message 
pyte | Non-zero if the card ts “disabled” by the BOOT CEG.TCS 
file or other TCS command 


hte S Non-zero if the card is powered an 

byte 3 Non- zero iP the card ts “sick eg. Ruled to respond 
correctly to microboor or POST 

bvie 4 The desired state of the card 

byte 5 Non-zero if the card has reached the desired st 
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1.5.2 SVC Function Descriptions 


00 SVC_NONE 


This is the state of to_tes_emd (paye zero) when no SVC request is pending 


(0 O) SVC_SET_COMP_STATE 
Set the desired state for the selected card. 
This command causes the TCS Master to begin changing the state of the se- 


lected card. Since some state changes take time. such as running microboot or 
POST the final desired state may not be achieved immediately. 


Arguments: 
byte 0) Card Class) Type 
byte | Cnused. for alignment 
bytes 2-3 Card Index 
byte 4 Card State 
Response: 
NONE 
@ SVC_GET_COMP_STATE 


Read the current state for the selected card. 


Arguments 
byte 0) Card Class) Ty pe 
byte | Cnused. for aligament 
byte 2-3 Card Index 
Response: 
byte 0) Non-zero if the curd has responded toa TCS messaze 
byte | Non-cero if the curd is “disabled” by the BOOTCEG. ECS 
file or other TCS command 
byte 2 Non-zero if the curd is powered on 
byte 3 Non-zero if the card is “sick”: eg. failed to respond 
correctly to microboot or POST 
byte 4 The desired state of the card 
byte 5 Non-zero if the card has reached the desired: state 
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12 SVC_SET_T1Y_XOFF 


Enable or disabled flow control on TCS console device 


Arguments: 
bytes 0-3 Non-zero value for enabling flow control 
Response: 
NONE 
13 SVC_GET_TTY_XOFF 


Read the current state of flow control on TCS console device 


Arguments: 
NONE 
Response: 
bytes 0-3 Non-zero value if flow control is enabled 
14 SVC_SET_DIALUC_ENA 


Enable or disable dialup access to the TCS modem. 


Arguments: 
bytes 0--3 Non-zero value for enabling dialup access 
Response: 
NONE 
15 SVC_GET_DIALUP_ENA 


Read the current state of dialup access tor the TCS modem 


Arguments 
NONE 
Response 
bytes 0-3 Non-zero value if dialup access is enabled 


Rev. 
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16 SVC_SET_DIALUP_PWD 
Set the TCS modem access password 


The TCS Master will read the dialup password string from the argument area. 
The string may be up to cight characters long and null-terminated 


Arguments: 
bytes 0-8 Up to cight character password string terminated with a 
NCCL character 
Response: 
NONE 
17 SVC_GET_DIALUP_PWD 


Read the current FCS modem access password. 


The TCS Master will write the current dialup password string into the response 
area. The string may be up to eight characters long and null-terminated. 


Arguments: 
NONI 
Response: 
bytes 0-8 Up toancight character password string terminated with a 
NULL character 
18 SVC_SET_DIALUP_INI 


Set the TCS modem initialization string. 


The TCS Master will read the dialup initialization string from the argument 
area. The string may be up to 64 characters long and null-terminated 


Arguments: 
bytes 0-64 Up toa 64 character initialization string terminated 
with a NCTE character 
Response: 


NONI 
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18 SVC_GET_DIALUD_IN! 
Read the current TCS modem initialization string 


The TCS Master will write the current modem initialization string into the re- 
sponse area. The string may be up to 64 characters long and null-terminated 


Arguments: 
NONE 
Response 
bytes 0-64 Up wa 64 character initialization string terminated 
with a NULL character 
1A SVC_GET_TEX_VER 


Read the TEN version string 


The TCS Master will write the current TEN version string into the response 
area. [he string may be up to 127 characters long and null-terminated. 


Arguments: 
NONE 


Response: 
bytes 0-127) Up toa 127 character TEN version string terminated 
with a NCEE character 


1B SVC_GET_SDRIVER_VER 
Read the Sdriver version string 


The TCS Master will write the current Sdriver version string into the response 
area. The string may be up to 79 characters long and null-terminated. 


Arguments 
NONI 
Response: 
bytes 0-79 Up toa 79 character Sdriver version string 


terminated with a NULE character 
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1c SVC_GET_DIAL!P_LOGG 


Read the state of TCS modem login flag. 


Arguments: 
NONE 
Response: 
bytes 0-3 Non-zero value if TCS modem is currently being used 
20 SVC_SHUTDOW? 


Shutdown the TC2000 system 


The TCS Master will begin a shutdown procedure. All processors will be 
halted. [f requested. all cards will be powered down, The operating system 
should not make this request until its own shutdown process has been done 
and all LO operations are complete. The TCS Master will acknowledge this 
request. giving a completion interrupt if requested. The actual halt will take 
place after a delay on the order of a few seconds. 


Arguments: 
byte 0 If zero. haltand power dowa all processors. Ef non-zero. 
leave all processors on after halting. 
Response: 


NONE 


Rev.: 10/19/88 9 


1: TEX Service Calls 


Documentation Standards 


21 SVC_REDOOT 
Reboot the TC2000 system. counting panics 


The TCS Master will reset all cards and then re-initialize them. Running mi- 
croboot and POST on all processor nodes. [It will then run the bootstrap and 
reload the system. The TCS Master acknowledge this request. giving a comple- 
tion interrupt if requested. The actual halt will take place after a delay on the 
order of a few seconds. 


Before restarting the system. the TCS Master will increment the bootstrap 
variable[O]. the pane count. and will compare it to the bootstrap variable] I]. 
the panic limit. [f the panic count reaches the panic limit, the system will not be 
reloaded and the service request will be treated as a SVC_SHUTDOWN. with 
the optional power shutdown, 


Before making this request. the operating system should assure that the cure 
rent boot string and other bootstrap variables have been passed to the TCS 
Master. Phe operating system should not make the request untifit has finished 
its own shutdown procedures and all FO operations have been completed. 


Arguments: 
byte 0 Meaningful only if the panie count has reached the panic 
limit. Then. [fzero, haltand power down all processors. [f 
non-zero leave all processors on after halting. 
Response 
NONE 
22 SVC_REREAD_CONFIG 


Reread the PCS system configuration files. 


The TCS Master will reread the configuration tiles. BOOTCEG.ECS and 
SLOTCEG.TCS. This will override any parameter changes that may been 
made since they were last read. The operating system may then choose to 
change a subset of the parameters and request a reboot. 


Arguments: 
NONI 


Response 
NONI 
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23 SVC_GET_BOOTSTRING 
Read the current boot string. 


The TCS Master will write the current boot string into the response area. The 
string may be up to 127 characters long and null-terminated. 


Arguments: 
NONE 


Response: 
bytes 0-127. Up toa 127 character boot string terminated with a 
NULL character 


24 SVC_SET_BOOTSTRING 


Set the boot string. 


The TCS Master will read a string of characters from the argument area and 
store it as the current noot string. The string may be upt to 127 characters long 
and null-terminated. This string will generally have been read from the 
BOOTCFG.TCS file. but may be overwridden by this function. This does 
NOT change the boot string contained in the BOOTCFG.TCS file. 


Arguments: 


bytes 0-127. Up to a 127 character initialization string terminated 
with a NULL. character 


Response: 

NONE 
25 SVC_GET_BOOTVAR 
Read the selected bootstrap variable. 


The TCS Master will copy the requested 32-bit bootstrap variable into the re- 


Ponse area. 


Arguments: 


byte 0) The index of the desired bootstrap variable| 15.0]. 
Response: 
bytes 0-3 The 32-bit value of that bootstrap variable. 
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26 SVC_SET_BOOTVAR 
Set the selected bootstrap variable 
The TCS Master will read the 32-bit variable value from the argument area. 


and store it in the selected bootstrap variable. This does not change the boot- 
strap variable information contained in the BOOTCFG.TCS file. 


Arguments: 
byte 0 - The index of the desired bootstrap variable[ 15.0]. 
bytes I-3 Unused. for alignment 
bytes 4-7 The 32-bit bootstrap variable value 
Response: 
NONE 
27 SVC_GET_CALENDAR 


Read the calendar’clock information from the TCS Master 


The TCS Master reads the current date and time from DOS. This number is a 
32-bit value that represents the number of seconds since 00:00:00 on January | 
1970, GMT. This number should have previously been set by DOS at TCS pow- 
er-up time from its onboard battery-backed clock. 


Arguments: 
NONE 
Response: 
bytes 0-3 The 32-bit time representation 
28 SVC_SET_CALENDAR 


Set the TCS Master's calendar clock information 


The TCS Master reads the current date and time from the argumentarea, This 
number is a 32-bit value that represents the number of seconds since 00:00:00 
on January | 1970, GME This number is then stored in DOS and the battery- 
backed clock. 


Arguments 
bytes U-3 The 32-bit ume representation 
Response 
NONE 
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29 SVC_EXIT 
Exit from application 
This function causes TEX to type “TCS: Exit.” and then to return to its com- 


mand prompt (as if the operator had type “*."). [tis provided as a less drastic 
halt than SVC_REBOOT or SVC_SHUTDOWN. 


Arguments: 
byte (-3 [f this 32-bit value is non-zero, then its value will also be 
printed 
Response: 
NONE 
2A SVC_WARM_BOOT_NODE 


Reboot the specified processor node 


This function causes the TCS Master to halt the specified node. reload and 
start microboot, leaving it in its wait loop, This function will fail if the node 
cannot be accessed or ifthe microboot image cannot be reloaded. It does NOT 
wait for the micreboot program to enter its idle wait loop. 


Arguments: 
byte 0 Card Class/Type (must be a processor) 
byte | Unused. for alignment 
bytes 2-3 Card Index 
Response: 
NONE 
2B SVC_COLD_BOOT_NODE 


Reset and reboot the specified processor node 
This function will cause the TCS Master to reset the specified node and restart 
the process of bringing that node to its current desired state. This function will 


fail if the processor node cannot be accessed. 


Arguments 


byte 0 Card Chass; wpe (must be a processor) 
byte | Unused. tor alignment 
bytes 2-3 Card Indes 


Response: 


NONE 
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2c SVC_START_NODE 
Perform a reset start on the selected processor node 


This function will cause the TCS Master to halt the specified processor node. 
and if requested. re-initialize the node. Then the TCS Master will load the 
proper branch instruction at address zero of the node. This branch instruction 
is based on the desired start address read from the argument area. The TCS 
Master will then issue the reset to the node. 


Arguments: 

byte 0) Card Class/Type (must be a processor) 

byte | Unused. tor alignment 

bytes 2-3 Card Index 

bytes 4-7 Start Address 

byte 8 If non-zero perform node initialization ‘after halt 
Response: 

NONE 

2D SVC_CONFIG_ARRAY 


Write the system contiguration array into the specified node 


This function causes the TCS Master to write out the node type and disable 
information into a predetermined area of the selected nodes main memory. 
The system configuration array contains node type and disable information, 
that both the diagnostics and the operating system use to quickly determine 
what nodes are present and usable within the system. 


Arguments: 
byte 0 Card Class. Type (must be a processor) 
byte | Unused. for alignment 
bytes 2-3 Card Index 
Response: 
NONE. 
2E SVC_TYPESCRIPT 


Append the console-log to the “ty halttes” tile located in the current working 
directory. 


Arguments 
NONE 


Response: 


NONE 
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2F SVC_REN_SCRIPT 


Append the console-log to the “ttyhalt.tes” fle located in the current working 
directory. and then rename that file to the file name specified in the argument 
area. 


Arguments: None 


Response: 
byte 0 Zero for success, otherwise a DOS errno value 


30 SVC_DO_UBOOT_NODE 

Load and start microboot on specified node 

‘This function causes the TCS Master to re-initialize the specitied node. then 
loads and starts microboot on it. The current state and desired state for this 
node is not changed. This function is to be used solely in a diagnostic environ- 


ment. This function does NOT verify that microboot successfully completed. 


Arguments: 


byte 0 Card Class/Type (must be a processor) 
byte | Unused. tor alignment 
bytes 2-3 Card Index 
Response: 
NONE 
31 SVC_DO_POST_NODE 


Load and start POST on specitied node 


This function causes the TCS Master to halts the specified node. thea loads 
and starts POST on it. The current state and desired state tor this node is not 
changed. This function is to be used solely in a diagnostic environment. This 
function does NOU verity that POST successfully completed 


Arguments 
byte O Card Class BWpe (must be a processor) 
byte | Unused. tor alignment 
bytes 2-3 Card Index 

Response 


NONE 
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32 SVC_KILL_NODE 
Halt and power-down a specified node 
This function causes the TCS Master to halt and power-down a specified node. 


The current state and desired state for this node is changed to UNKNOWN, 
This function is to be used solely in a diagnostic environment. 


Arguments: 
byte 0 Card Class/Type (must be a processor) 
byte | Unused. for alignment 
bytes 2-3 Card Index 
Response: 
NONE 
33 SVC_JUMP_APP_NODE 


Get console output from specified node 


This function causes the TCS Master to perform a “utility slave” command for 
the specified node. and then an “application ty” command. Thus getting con- 
sole from that node. This function is to be used solely ina diagnostic environ- 
ment. 


This function must be used with caution. If the specified node is NOT running 
an application. it will appear as if the TEX is hung. Simply type 7". to return 
to the TEX command prompt. if this is the case. 


Arguments: 
byte 0 Card Class/Type (must be a processor) 
byte | Unused. for alignment 
bytes 2-3 Card Index 

Response: 


NONE 
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45 SVC_DOS_READ 
Read the specified number of bytes from a file with the specified tile handle. 


This function causes the TCS Master to perform a DOS read on a file. The 
maximum number of bytes allowed to be read is 128. The file handle and num- 
ber of bytes to be read are read from the argument area. The number of bytes 
actually read. and the bytes themselves, are written into the response area. If 
the bytes actually read is zero. an End-of-File was reached. Ifthe bytes actual- 
lv read is equal to minus one (-!) an error has occurred. and the DOS errno 
value is written into response area. 


Arguments: 
bytes 0-3 File handle (previously returned from SVC_DOS_OPEN) 
bytes 4-7 Number of bytes to be read 

Response: 
bytes 0-3 Number of bytes actually read. Uf zero, indicates 

end-of-tile reached. if minus one (-1) indicates an error. 

byte 4 {fan error occurred, this is the DOS errno value. 
bytes 5-7 Unused. for alignment 


bytes 8-131 Up to 128 bytes of data (if no errors occurred) 


46 SVC_DOS_WRITE 
Write the specitied number of bytes into a file with the specified file handle. 


This function causes the TCS Master to perform a DOS write on a file. The 
maximum number of bytes allowed to be written is 128. The file handle. num- 
ber of bytes to be written, and the bytes themselves are read from the argument 
area. The number of bytes actually written are written into the response area. 
If the bytes actually written is equal to minus one (-1) an error has occurred. 
and the DOS errno value is written into response area. 


Arguments: 
bytes 0-3 File handle (previously returned trom SVC_DOS_OPEN) 
bytes 4-7 Number of bytes to be written 


bytes S-131 Up to 128 bytes of data 


Response: 
bytes 0-3 Number of bytes actually written, Ef minus one (-1) 
Indicates an error 
byte 4 It an error occurred. this is the DOS errno value. 
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49 Svc_DOS_DELETE 

Delete a DOS file 

The TCS Master will delete a specified file from the DOS file system. A string 
of characters (up to [28) containing the name of the file to be deleted is read 


from the argument area. 


Arguments: 
bytes 0-127. String of up to 128 characters containing name of file 


Response: 
byte 0) Zero for success. otherwise a DOS errno value 


4A SVC_DOS_MKDIR 

Make a DOS directory 

The TCS Master will create a specified directory within the DOS file svstem. A 
string of characters (up to 128) containing the name of the directory to be 


created is read from the argument area. 


Arguments: 
bytes 0-127) String of up to 128 characters containing name of directory 


Response: 
byte 0 Zero for success. otherwise a DOS errno value 


4B SVC_DOS_RMDIR 

Remove a DOS directory 

The TCS Master will delete a specified directory within the DOS file system, A 
string of characters (up to 128) containing the name of the directory to be de- 


leted is read from the argument area. 


Arguments: 
bytes 0-127) Stringof up to 128 characters containing name of directory 


Response: 
byte 0 Zero tor success. otherwise a DOS errno value 
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Constant 


PCS_RDONLY 


TOS_WRONLY 


PCS_RDWR 


OS 


Rev. 


CS. 


CSL 
Cs. 


OS. 
CS 


APPEND 


CROAT 


TRUNG 
ENC 


TENI 
BINARY 
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4c SVC_DOS_GETCWD 
Get the Current Working Directory 
The TCS Master will report the current directory from the DOS file system. A 


string of characters (up to 67) containing the name of the current directory will 
be written into the response are. 


Arguments: 
byte 0 The number of available bytes for the string 
Response: 
byte 0-66 Up to 67 characters containing current directory name. 
DOS specities the length to be a maximum of 67 characters 
including the NULL. The first three characters are the 
drive letter, a colon and a backslash. 
4D SVC_DOS_OPEN 


Open a specitied file for specified operations. 


This function causes the TCS Master to perform a DOS open ona tile. A maxi- 
mum of 10 files can he maintained by the TCS Master. The operations word 
and the file name are read from the arguments area. The file handle number is 
Written into the response area upon completion of the open operation. ff the 
file handle is equal to minus one (-1) an error has occurred. and the DOS errno 
value is also written into response area. The operations word is formed by bit- 
Wise-ORing the constants (or values) from the table below. 


Value Operations Word Description 

OOOO, Opens file for reading onive il this flag ts given neither 
ICS_RDWR nor TOS_WRONLY can given. 

Oxu00 | Opens file for writing only: i this fag is given neither 
ICS _RDWE nor FOS_-RDONLY can given. 

OxON02 Opens file for both reading and writing only: af this Flag is 
given neither PCS _WRONLY nor EOS RDONLY can 
given 

(0008 Repesiuen file pomter to tne end ef the file before even 


Write operon. 
(0100 Creates and opens anew file lor werting: this has no effeet il 


the Tile already exists 


60200 Opens and truncates the file to zero fength. 

ON0400 Returns.an error value i the file already exists. Only applies 
when used with LOS CRE AT 

Oy4000 Opens the Hem text (transiated) mode 

Oyso00 Opens the fle in bina cuntranstited) mode. 
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Arguments: 
bytes 0-3 Operations word 
bytes 4-7 Unused. for alignment 


bytes 8-131 0 Up to 128 characters containing file name (including path) 


Response: 
bytes 0) Zero for success. or DOS errno value 
bytes 1-3 Unused. for alignment 
bytes 4-7 File handle number 

4E SVC_DOS_CLOSE 


Close the DOS file with the specified file handle. 


This function causes the TCS Master to perform a DOS close ona file. The file 
handle is read from the argumentarea. The number of bytes actually read, and 
the bytes themselves. are written into the response area 


Arguments: 

bytes (-3 File handle (previously returned from SVC_DOS_OPEN) 
Response: 

byte 0 Zero for success. or DOS errno value 
4F SVC_DOS_SEEK 


Seek the specified number of bytes within a DOS tile with the specified file 
handle, 


This function causes the TCS Master to perform a DOS Iseek ona tile. The tile 
handle and number of bytes to be seck from the beginning of the file are read 
from the argument area. The file position (number of bytes from the begin- 
ning) is Written into the response area. Hf the file position is cyual to minus one 
(-1) an error. has occurred. and the DOS errno value is written into response 


area. [tis possible to seek past the end of a DOS file! 


Arguments: 
bytes 0-3 File handle (previously returned trom SVC_DOS_OPEN) 
bytes 4-7 Number of bytes to scek from beginning 
Response: 
bytes 0 Zero for success. or DOS errno value 
bytes 1-3 Lnused. tor alignment 
bytes 4-7 File position (byte offset from beginning of file) 
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50 SVC_DOS_READLN 
Read the specified number of bytes from a file with the specified tile handle. 


This function causes the TCS Master to perform a DOS modified read ona 
file. The maximum number of bytes allowed to be read is 128. The file handle 
and number of bytes to be read are read from the argument area. Characters 
are read from the current file position up to and including the first new-line 
character (\n’). up to the end of the file. or until the number of characters read 
is equal to the bytes to be read. whichever comes first. The number of bytes 
actually read. and the bytes themselves. are written into the response area. If 
the bytes actually read is zero. an End-of-File was reached. Ifthe bytes actual- 
ly read is equal to minus one (-1) an error has occurred. and the DOS errno 
value is Written into response area. 


This routine is very similar to an fgets() function. and should only be per- 
formed on ASCII files opened in text mode. This routine can be executed onan 
ASCII file opened in binary mode. vou will. however. get the <CR> character 
that precedes the <LF> or new-line character. 


Arguments: 
bytes 0-3 File handle (previously returned from SVC_DOS_OPEN) 
bytes 4-7 Number of bytes to be read 

Response: 
bytes 0-3 Number of bytes actually read. [Tf zero. indicates 

end-of-file reached. if minus one (-1) indicates an error. 

byte 4 [fan error occurred. this is the DOS errno value. 
bytes 5-7 Unused. tor alignment 


bytes 8-131 Up to 128 bytes of data (if no errors occurred) 


51 SVC_DOS_RDDIR 
Read the contents of a specified directory. 


This function causes the TCS Master to perform a series of DOS function calls. 
based on the arguments read from the argument area. Since the response to 
this SVC depends on the contents of a director, the type of file information 
being requested. and the limited size of the response area. only five file infor- 
mation structures can be passed back per SVC call. This requires that the 
programmer must provide file index along with a file atuributes flag and search 
filename (wildeards © and "are permissible). 
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Constant 
1CS_A_NORMAL 


VCOS_A_RDONLY 
1CS_A_HIDDEN 
VCOS_A_SYSTEM 
VCOS_A_VOLID 


VOS_A_SUBDIR 
ICS A_ARCH 
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File attributes flag description 


Normal. File can be written or read without restricuion, 
Read only. File cannot be opened for a “write”, and a file 
with the same name cannot be created. Normal tile 
information also returned. 

Hidden file. Cannot be found by a directom search. Normal 
file information also returned. 

System file. Cannot be found by a directon search. Normal 
Nile information also returned. 

Volume ID. Only one file can have this attribute, and it must 
bein the root director. 

Subdirecton. Normal file information alse returned. 
Archive. Set whenever the file is changed. and cleared by 
the MS-DOS BACKUP command. 


The response area contains the number of file records read. whether there are 
potentially more matching files. the file record index to be used if there are 
potentially more matching files. and the file records themselves (up to five). 
Each file record is consists of 24-bytes. constructed as follows: 


File 


Arg 


record: 

bytes 0-12 
byte 13 

bytes 14-15 
bytes 16-17 
bytes 18-19 
bytes 20-23 


uments: 
bytes 0-3 
bytes 4-7 
bytes 8-135 


Response: 


byte 0) 
byte | 


by tes 
by tes 


by tes S-127 


File name (13-bytes including NULL terminator) 

File attributes 

File index 

Time. bit values (hour{ 15.. 11 ]-minutes| 10..5].seconds|4..0]) 
Date. bit values (year 15..9].month{8..5].day|4..0]) 

Size. length of file in bytes 


File attributes Hag 
File record index (lirst file record to be saved) 
Search filename (wildcards are permissible) 


Number of file records read 

Done-flag (non-zero indicates there are NO more tiles 
matching the arguments descriptions) 

Cnused. tor alignment 

Index to the next file record (only used if the Done-fag 
had not been set) 

Up to five 4-byte file records 
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80 SVC_TCS_RD_ACTION 


This command causes the TCS Master to send an ACTION register read re- 
quest to the TCS slave on the specified card. 


Arguments: 
byte 0 Card Class/Tvpe 
byte | Unused. for alignment 
bytes 2-3 Card Index 
byte 4 Action register number 
Response: 
byte 0 Zero for success. non-zero for error 
byte | Data read from action register 
81 SVC_TCS_WR_ACTION 


This command causes the TCS Master to send an ACTION register write re- 
quest to the TCS slave on the specified card. 


Arguments: 

byte 0) Card Class/Type 

byte | Unused, for alignment 

bytes 2-3 Card Index 

byte 4 Action register number 

byte 5 Data to be written 
Response: 

byte 0 Zero tor success. non-zero tor error 
82 SVC_TCS_RD_EEPROM 


This command causes the TCS Master to send an EEPROM register read re- 
quest to the TCS slave on the specified card 


Arguments: 

byte 0 Card Class. Wpe 

byte | Unused. tor alignment 

bytes 2-3 Card Index 

byte 4 FEPROAME register number 
Response 

byte 0 Zeto tor success. non-zero tor error 

byte | Data read from EEPROM register 
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83 SVC_TCS_WR_EEPROM 


This command causes the TCS Master to send an EEPROM register write re- 
quest to the TCS slave on the specified card. 


Arguments: 

byte 0 Card Class/Tvpe 

byte | Unused. for alignment 

bytes 2-3 Card Index 

byte 4 EEPROM register number 

byte 5 Data to be written 
Response: 

byte 0 Zero tor success. non-zero for error 
84 SVC_TCS_RD_GATEARRAY 


This command causes the TCS Master to send an Gate Array register read 
request to the TCS slave on the specified card. 


Arguments: 

byte 0 Card Class/ Type 

byte | Unused. for alignment 

bytes 2-3 Card tides 

byte 4 Gate Array number 

byte 5 Gate Array register number 
Response: 

byte 0 Zero for success. non-zero for error 

byte | Data read from Gate Array register 
85 SVC_TCS_WR_GATEARRAY 


This command causes the TCS Master to send an Gate Array register write 
request to the TCS slave on the specified card. 


Arguments: 
byte 0 Card Class Type 
byte | Unused. for alignment 
bytes 2-3 Card Index 
byte t Gate Array number 
byte 5 Gate Array register number 
byte 6 Data to be written 
Response 
byte 0 Zero tor success. non-zero for error 
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86 SVC_TCS_RD_HWARE 


This command causes the TCS Master to send an HARDWARE register read 
request to the TCS slave on the specified card. 


Arguments: 

byte 0 Card Class/Type 

byte | Unused. tor alignment 

bytes 2-3 Card Index 

byte 4 Hardware register number 
Response: 

byte 0 Zero for success. non-zero for error 

byte | Data read from Hardware register 
87 SVC_TCS_WR_HWARE 


This command causes the TCS Master to send an HARDWARE register write 
request to the TCS slave on the specified card. 


Arguments: 
byte 0 Card Class/Tvpe 
byte | Unused. for alignment 
bytes 2-3 Card Index 
byte 4 Hardware register number 
byte 5 Data to be written 
Response: 
byte 0 Zero for success, non-zero for error 
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88 SVC_TBUS_RD 


Perform a T-Bus read cycle on desired processor node. 


This function causes the TCS Master to send a TCS T-Bus memory setup re- 
quest and a T-Bus memory read request to the TCS Slave on the specified pro- 
cessor node. The requestor MUST correctly format all the bytes of this 
message or the remote T-Bus may be inadvertently hung. This command al- 
lows complete freedom in setting up the request. and does NO validity check- 


ing. 


Arguments: 
byte 0 
byte | 
bytes 2-3 
byte 4 
byte 5 
byte 6 
byte 7 
byte 8 
bytes 9-11 
bytes 12-15 


Response: 
byte 0 
byte | 
bytes 2-3 
bytes 4-7 


Card Class/Type 
Unused. for alignment 
Card Index 


Memory setup CMD MOD byte (SIGA A’B selector) 


Memory setup TBus Command 
Memory setup TBus CMOD1 
Memory setup TBus CMODO 

TBus Read CMD MOD (increment) 
Unused, for alignment 

TBus address bits 31..0 


Nack or Ack code from TCS Slave 
TBus response byte 

Unused, for alignment 

Data read trom TBus cvele 
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89 SVC_TBUS_WR 


Perform a T-Bus write cycle on desired processor node. 


This function causes the TCS Master to send a TCS T-Bus memory setup re- 
quest and a T-Bus memory write request to the TCS Slave on the specified 
processor node. The requestor MUST correctly format all the bytes of this 
message or the remote T-Bus may be inadvertently hung. This command al- 
lows complete freedom in setting up the request. and does NO validity check- 


ing. 


Arguments: 
byte 0 Card Class/Type 
byte | Unused. for alignment 
bytes 2-3 Card Index 
byte 4 Memory setup CMD MOD byte (SIGA A/B selector) 
byte 5 Memory setup TBus Command 
byte 6 Memory setup TBus CMOD1 
byte 7 Memory setup TBus CMODU 
byte 8 TBus Read CMD MOD (increment) 
bytes 9-11 Unused. tor alignment 


bytes 12-15 TBus address bits 31..0 
bytes 16-19 [Bus write data 


Response: 
byte 0 Nack or Ack code trom TCS Slave 
byte | TBus response byte 


SVC Argument Descriptions 
This section describes the standard argument values that can be passed to the 


SVC commands that deal specifically with the various card types within a 
TC2000 system. 


Card Class/Type 


a0 SVC_CC_CLA IC CLR of PO CTT devel bi clock card 
Ol SN UCC SA IC SS or VOUS switch semer A card 
02 SVC LOC USB IC SS or FOCUS switch server B card 
O38 SUC LCC URSN EC US switch requestor \ card 

o4 SVC_CO_RB CUS switch requestor B card 

5 SVC_CO_NODI 1C PPX or other processor node 

Oo SAC _ CO CUNT PCCCEE level 2) clock AW card 

7 SVC_CC_CER2B HC Cl level 2) clock B card 

OS SEC UCC LNA IC US switch middie \ card 

i) SVC _CO_MB IC US switch middle B card 
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Card Index 


This argument is the index of a particular Card Class/Type. There can at most 
two first level clock cards, seven second level clock cards, sixty-four of each 
switch card type and 512 processors. 


Card Class Index Range 
SsVC_CC_CLK OxO00...0800 | 
SVC_CC_SA Ox000...0X03 F 
SVC_CC_SB Ox000...O0X03F 
SVC_CC_RA Ox000...O803F 
SVC_CC_NODE OX000...08 LPF 
SVC_CC_CLRK2A Ox000...0N007 
SVC_CC_CLK2B OxO00...OX007 
SVC_CC_MA Ox000...ON03 F 
SVC_CC_MB 000.0803 F 
Card State 

This is) the argument that is) used in conjunction with the 


SVC_SET_COMP_STATE command. This is an overall state or goal for the 
specified card. [t hides many other more detailed states which may change 
with versions od software. The states are analogous to those specified by the 
“CardUse™ line in the BOOTCEG.TCS file and the “Configuration Card- 
Use” TEX command. The operating system or diagnostic may request that a 
specilic card be placed in one of the states listed below, 


Ol SMC _LCS_SY¥S System usage 

02 SVC_CS_AUX Auxiliary usage 

03 SVC_CS_ISOLATT. Isolated usage 

04 SVCO_CS_ON Disabled on usage (nodes only) 
05 SVC_CS_OFE Disabled off usage 
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